'\" t
.TH cm2_unlock 1 "20 August 2007" "Code Manager II"

.SH NAME
cm2 unlock \- Remove lock on checked out files

.SH SYNOPSIS
cm2 unlock [\fB--verbose\fP] [\fB--force\fP] file ...

.SH DESCRIPTION
The \fIcm2 unlock(1)\fP utility is used to remove locks on checked out files.
This is particularly useful if a developer wishes to discard changes to a
file. This is a two-step process - the file should be first unlocked, and then
the most recent check in version retrieved [via \fIcm2 get(1)\fP].

This tool also optionally allows locks for other users to be removed as well.

.SH ARGUMENTS
.TP 8
.B --verbose
Show some progress messages as files are unlocked.
.TP
.B --force
Must be specified if any of the files on the command line are locked
by developers other than the current user.

This argument can also be used if the file is currently checked out by 
someone else and you wish to unlock it in them. This is only possible if
you have read access to the checked out version and are able to write to the
directory.

.SH EXIT CODES
The \fIcm2 unlock(1)\fP utility follows UNIX standard practise:

.TP 4
.B 0
All files have been successfully unlocked.
.TP
.B >0
One or more files were not unlocked.

.SH NOTES
Use of the \fB--force\fP should only be used with the consent of the other
developers involved in the particular project to ensure they are not
currently editing the code that is being unlocked!

.SH AUTHOR
The \fBCode Manager II\fP tool set was written by Simon Edwards, Proprius Consulting Ltd, (\fBwww.proprius.co.uk\fP).

.SH SEE ALSO
.BR cm2(1),
.BR cm2_mci(1),
.BR cm2_mco(1),
.BR cm2_status(1).

.SH AVAILABILITY
This utility was specifically written under the GNU GPL license and as required
by such software comes with \fIno warranty or guarantee of any kind\fP.

